home *** CD-ROM | disk | FTP | other *** search
/ System Booster / System Booster.iso / Archivers / SkBackup / SkBackup.doc < prev    next >
Encoding:
Text File  |  1996-09-27  |  8.1 KB  |  256 lines
  1.                                 
  2.                         *********************************
  3.                         *       Skandal Backup v1.2     *
  4.                         *********************************
  5.  
  6.  
  7. LEGAL & DISCLAIMER
  8.  
  9. This program is Mailware. If you use it, send us an E-Mail at the
  10. addresses found in THE AUTORS section.
  11. You can redistribute it as long as the packet retains it's original form,
  12. and no changes where made to the files included.
  13. You CANNOT use the program in commercial packages; PD companies should
  14. contact Alessandro Pozzoli if they want to sell them with a PD collection.
  15. Only Fred Fish and Aminet CD ROM are authorized to do so without notice.
  16.  
  17.  
  18. Cause this programs deals with files & directories, WE CANNOT BE CONSIDERED
  19. BY ANY MEANS RESPONSABLE FOR DIRECT OR INDIRECT DAMAGE CAUSED BY THE USE OF
  20. THIS PROGRAM. Use at your own risk.
  21. I (Dario) and Alessandro use them regularly since 6 months without any kind
  22. of problem.
  23. Read IMPORTANT NOTES before using it.
  24.  
  25.  
  26. INTRODUCTION
  27.  
  28. At our university lab we have to pass trough a PC for downloading wares
  29. from the net, and many problems arises:
  30.  
  31. 1) File names where badly truncated or not accepted, so we had to rename
  32.    them manually <gasp!>
  33. 2) We have ONE pc for SIXTY users, so we have to optimize the files
  34.    in pre-sized directories to leave as less empty space on the disks
  35.    as we can, and to transfer FAST from the pc to allow other users
  36.    do the same.
  37.  
  38. So Alessandro tought, downloading a unique file of 1420k is surely faster
  39. and wastes less disk space than downloading 100 files of 14k.
  40. In other words, we need a simple program wich takes tons of still archived
  41. things (so compression is not needed) and organizes it in a huge file
  42. splitted to disk boundaries, and obviously able to reintegrate all
  43. on our personal at home. Cause our Unix lha version is not compatible
  44. with the Amiga one, here it is.
  45. It was developed on HP/UX RISC machines.
  46.  
  47.  
  48. PROGRAM INSTALLATION & GUIDELINES
  49.  
  50. Of course, you can use the program for many purposes, i.e. non compressed
  51. backup of whatever you want.
  52. This archive contains:
  53.  
  54. 1) The source of the executable (compile it on Amiga or your Unix client)
  55. 2) Amiga binary executable 
  56. 3) Binaries & source for an easy use Amiga GUI interface (SkBackupWin).
  57. 4) This doc file
  58.  
  59. An MS-DOS executable version will be released when my brother will finish
  60. with his thesis at university, so leaving to me the PC :).
  61.  
  62.  
  63.         -) Unix installation: simply compile it with
  64.  
  65.                 cc <source> -oSkBackup
  66.  
  67.  
  68.         -) Amiga installation: copy it whatever you want.
  69.            If you decide to use the GUI frontend, place SkBackup
  70.            anywhere in your PATH. (I suggest C:...)
  71.  
  72.  
  73. The program idea is simple: it receives a directory name as input,
  74. a size (in k or bytes), and then stores them all in an unique file,
  75. splitting it every <size> bytes.
  76. The file(s) will look similar to <Name>.000 <Name>.001 etc.
  77.  
  78.  
  79.  
  80. CLI USAGE
  81.  
  82. Here is what you'll see if you simply type 'SkBackup' at CLI prompt
  83. (Unix usage is exactly the same; anyway, see NOTES below):
  84.  
  85.  
  86.                     Skandal Backup Program V1.1
  87.                      Author Pozzoli Alessandro
  88.                           Copyright 1994
  89.                            Amiga Version
  90.  
  91. All rights reserved. Not for commercial use.
  92. Compatibility:  Amiga - Unix - Ms-Dos
  93. For Infos or Bug Mail pozzoli@ghost.dsi.unimi.it University of Milano
  94.  
  95. Usage : Backup [-<option>] <command) Backup_File length_archive [Dir]
  96.                                        (a,e,l)       (a,s)
  97.  
  98.  Command:
  99.    a  add files
  100.    e  extract files
  101.    l  list files
  102.    s  statistic files occupation
  103.  
  104.  Option:
  105.   -n  Create new backup file (not append) (a)
  106.   -d  delete  files (a,e)
  107.   -r  recursively directory (a,s)
  108.   -b  length in byte (a,s)
  109.   -v  verbose mode off (a,e)
  110.   -k  disk request off (a,e,l)
  111.  
  112.  
  113. I think it's pretty straightforward, so i go with some exaples to make
  114. you the thing brighter:
  115.  
  116.  
  117. 1) Create an archive from scratch on the harddisk, splitted every
  118.    1422k (max size on a PC HD diskette). The dir wich contains you stuffs
  119.    is called MyStuffs, you wanna keep them, you want to call the archive 
  120.    Things, and want to know what happens during archiviation.
  121.    So here we go:
  122.  
  123.    skbackup -nk a Things 1422 Mystuffs
  124.  
  125.    or
  126.  
  127.    skbackup -krnb Things 1456128 MyStuffs   (1k = 1024 bytes!)
  128.  
  129. 2) You have limited diskettes, and want to know the occupation in
  130.    number of diskettes with a given splitting size. So:
  131.  
  132.    skbackup -r s 1422 MyStuffs
  133.  
  134.    this command will tell you how many PC HD disks you need, and how
  135.    many bytes are free on the last disk, if any.
  136.  
  137. 3) You wanna archive fast directly on diskettes, and directly delete
  138.    the sources files. Now:
  139.  
  140.    skbackup -rvnd a Things 855 MyStuffs
  141.  
  142.    this will store the files deleting them after storing, and ask you
  143.    to insert a new disk every 855k.
  144.  
  145. 4) You want to know what is in your archive files on diskettes.
  146.  
  147.    skbackup l Things
  148.  
  149. 5) You want to add some things cause there are still space in the last
  150.    part of the archive.
  151.  
  152.    skbackup -kv a Things 1422 MyStuffs2 
  153.  
  154.    Please note the absence of the -n option and the use of another source
  155.    dir: skbackup WILL NOT check for duplicates.
  156.  
  157. 6) You arrived home and wanna extract all on your hd, deleting the archive
  158.    from the diskettes so they'll be ready for the next time...
  159.  
  160.    skbackup -dr e Things.000
  161.    
  162.    or, if you want to extract from hd,
  163.  
  164.    skbackup -drk e Things.000
  165.  
  166. That's all I think; read the notes anyway cause you can find some troubles
  167. if you don't take care of them...
  168.  
  169.  
  170. IMPORTANT NOTES
  171.  
  172. 1) When you call Skbackup for creating or adding, you MUST be in a different
  173.    directory than these of the files to be archived (I suggest the parent;
  174.    see note 2). If you forgot this, SkBackup will run in an infinite loop
  175.    cause he catch recursively the created files as new entries to archive!
  176.    And this can be VERY annoing for your HD and OS, especially on UNIX!
  177.  
  178. 2) When extracting, SkBackup creates automatically the directory you
  179.    passed as input on creation. So be careful about same names directories,
  180.    and avoid strange names and long paths (expecially from Amy to Unix).
  181.  
  182.    Those paths can cause havoc from Unix to Amiga:
  183.  
  184.    /pub/usr/users1-100/rosati/bin/pub    cause "/" at the beginning means
  185.                                          parent on Amiga;
  186.  
  187.    ~rosati/.    /^F/^C/../               no comment... :)
  188.  
  189.     Dont'use ~,^,.. and . if you can.
  190.  
  191.  
  192.     From Amiga to Unix avoid things like this:
  193.  
  194.     Ram Disk:give/a/call/to/DataZone/
  195.  
  196.  
  197.     In a word: go in the parent dir and use a normal letters name,
  198.     cause if you specify a/b/c/d/e/f/g/h/i on adding, on extract
  199.     you will have to do a "cd a/b/c/d/e/f/g/h/i" to found your files...
  200.  
  201.     And think twice when you use the -d option!!!
  202.  
  203. 3)  If you loose an archive part, files after the point missing
  204.     or corrupted are LOST!
  205.     Sorry guys, this isn't AmyBackTools...
  206.  
  207.  
  208.  
  209. MAKE IT EASY: SKBACKUPWIN
  210.  
  211. Easy to say, we Amiga users of the lab immediately started using it,
  212. cause we where bored of archive renaming and dozens of minutes spent
  213. optimizing the diskette usage.
  214. So I (Dario) decided to write a simple GUI for skbackup.
  215. There it is: SKBackupWin. It exactly acts as the CLI command, in a 
  216. more friendly way I hope... all gadgets are straightforward.
  217. When you click on GO gadget, the frontend simply passes command and
  218. parameters to the CLI executable via System().
  219.  
  220. If you are adding or creating an archive, the program will ask
  221. you the name of the file to create and then the directory to backup,
  222. via ASL requesters. The same happens on extract.
  223.  
  224.  
  225.  
  226. SOME FINAL WORDS
  227.  
  228. We wrote these tools mainly for fun, so take them as they are.
  229. Maybe 'll release an MS-DOS executable, maybe not.
  230. Anyway, report bugs to Alessandro Pozzoli or to Dario Rosati if you
  231. found one.
  232. Long live to Amiga!
  233.  
  234.  
  235.  
  236. THE AUTHORS
  237.  
  238. You can reach us at the following E-Mail addresses:
  239.  
  240. -) Alessandro Pozzoli (Willow/Skandal): pozzoli@ghost.dsi.unimi.it
  241.  
  242. -) Dario Rosati (Xenon/Skandal): rosati@ghost.dsi.unimi.it
  243.                                  Dario_Rosati@ccmail.uni-bocconi.it
  244.  
  245.  
  246. Or leave a mail to Xenon on DataZone BBS:
  247.  
  248. +39-2-70633892 21->14 local time, 2400->28800 V.FC
  249.  
  250.  
  251. Greetings to all in Skandal and to all you out there...
  252.  
  253.  
  254.  
  255.  
  256.                                             Willow & Xenon